home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / util / wb / copperfa.readme < prev    next >
Text File  |  1998-03-07  |  6KB  |  156 lines
  1. Short:    Copper Color-Fade on WB + Source. V1.0
  2. Author:   pernathw@stud.fak11.uni-muenchen.de (Wanja Pernath)
  3. Uploader: Author
  4. Version:  1.0
  5. Type:     util/wb
  6. Requires: OS3.x / AGA chipset
  7.  
  8. DEUTSCH
  9. =======
  10.  
  11. ColorFade ist ein simples CLI-Programm, mit dem man einen Farbverlauf auf  einem
  12. beliebigen Public Screen erzeugen kann.
  13.  
  14. Was, noch ein unnützes Schmeiß-Doch-Weg-Programm?
  15.  
  16. Nee! CopperFade hat nämlich so  seine  Vorteile  im  Bezug  zu  MagicCopper  und
  17. ähnlichen anderen Programmen.
  18.  
  19. Denn:  - CopperFade kann auf einem beliebigen PublicScreen eingesetzt werden
  20.        - CopperFade kann einen beliebigen Ausschnitt des Views »faden«
  21.        - CopperFade hat einen An- und einen Abschwellfaktor
  22.        - CopperFade ist FreeWare
  23.        - CopperFade's Source-Code in C wird mitgeliefert
  24.        - CopperFade wurde von mir geschrieben ;)
  25.  
  26. Um CopperFade einfach mal zu testen, sollte man all seine mehrfarbigen Patterns
  27. auf der Workbench wegwerfen. Danach im CLI zum Beispiel
  28.  
  29.   copperfade c=0 step=4 0 0 127 0 65 41 126 27 42
  30.  
  31. eingeben  und  schon   hat   man   einen   super-psychedelischen-blau-grün-roten
  32. Hintergrund.
  33.  
  34. Verwendung:
  35. -----------
  36.  
  37. TEMPLATE    PS=PUBSCREEN/K,C=COLOR/K/N,STEP/K/N,YSTRT/K/N,YSTOP/K/N,RESET/S,
  38.             R1/A/N,G1/A/N,B1/A/N,R2/A/N,G2/A/N,B2/A/N,R3/N,G3/N,B3/N
  39.  
  40. KEYWORD       BEDEUTUNG
  41. -----------------------
  42. PS=PUBSCREEN  Name des öffentlichen Screens. Wenn nicht angegeben, wird der
  43.               voreingestellte (meist Workbench) verwendet.
  44.  
  45. C=COLOR       Hier muß der zu verwendende Paletteneintrag angegeben werden.
  46.               Zum Beispiel 0 für die Hintergrundfarbe.
  47.  
  48. STEP          Jede STEPte Zeile bekommt eine andere Farbe zugeteilt.
  49.  
  50. YSTRT         Ab welcher Zeile soll begonnen werden.
  51. YSTOP         Und bis zu welcher Zeile soll der Farbverlauf gehen.
  52.  
  53. RESET         Will man nur einen bestimmten Ausschnitt des Views haben, so kann
  54.               man diesen Schalter angeben. Denn hierbei wird die verwendete
  55.               Farbe nach Erreichen von YSTOP auf ihren Ursprungswert
  56.               zurückgesetzt.
  57.  
  58. R1,G1,B1      Die Start- und Endwerte des Farbverlaufs. Diese Werte müssen
  59. R2,G2,B2      angegeben werden.
  60.  
  61. R3,G3,B3      Diese Werte sind optional und sind nur dann sinnvoll, wenn man
  62.               einen Farbverlauf zwischen drei Werten haben möchte.
  63.               Alle diese Einträge haben einen Wertebereich zwischen 0 und 255
  64.               und bilden somit das 16,8Mio Farb-Spektrum der AGA-Chips.
  65.  
  66.  
  67. Hinweise:
  68. ---------
  69.  
  70. Man kann ColorFade jederzeit durch ein CTRL/C abbrechen lassen.
  71.  
  72. Vorsicht: ColorFade prüft zu Beginn, ob schon ein Programm die User Copper Liste
  73. des  Bildschirms  belegt  hat.  Es  gibt  jedoch (momentan) keine Möglichkeit zu
  74. testen, ob nach dem Start von ColorFade ein weiteres Programm (MagicCopper)  die
  75. CopperListe belegt hat. Es kann zu merkwürdigen Zwischenfällen kommen, falls dem
  76. so sein sollte.
  77.  
  78. ================================================================================
  79.  
  80. ENGLISH
  81. =======
  82.  
  83. CopperFade is a simple CLI-Utility to generate a color-fade an any public screen
  84. with a variable color pen number.
  85.  
  86. No! This is NOT another Drop-Away-Utility.
  87.  
  88. This is CopperFade. And CopperFade has many advantages to other utilites of  its
  89. kind.
  90.  
  91. Because:    - CopperFade can use any public screen not only the Workbench
  92.             - CopperFade can fade a variable part of the given screen
  93.             - CopperFade's color-fade can grow and grow down
  94.             - CopperFade is FreeWare
  95.             - CopperFade's source code in C comes with this archive
  96.             - CopperFade was written by me ;-)
  97.  
  98. To test CopperFade for the first time, clear your multi-colored patterns on  the
  99. Workbench and type something like
  100.  
  101.   copperfade c=0 step=4 0 0 127 0 65 41 126 27 42
  102.  
  103. and you can see a super-psycho-blue-green-red background.
  104.  
  105.  
  106. Usage:
  107. ______
  108.  
  109. TEMPLATE    PS=PUBSCREEN/K,C=COLOR/K/N,STEP/K/N,YSTRT/K/N,YSTOP/K/N,RESET/S,
  110.             R1/A/N,G1/A/N,B1/A/N,R2/A/N,G2/A/N,B2/A/N,R3/N,G3/N,B3/N
  111.  
  112. KEYWORD       MEANING
  113. ---------------------
  114. PS=PUBSCREEN  Name of the public screen to be used for the color-fade.
  115.               If not given, the default public screen (Workbench) will be used.
  116.  
  117. C=COLOR       The pen number for the color-fade, like 0 for the background.
  118.  
  119. STEP          Each STEP line gets a new color.
  120.  
  121. YSTRT         Start of fading.
  122. YSTOP         End of fading.
  123.  
  124. RESET         If you want to fade only a little part of the screen, set RESET
  125.               and after reaching YSTOP, CopperFade will reset the color to the
  126.               original value found there.
  127.  
  128. R1,G1,B1      Start and stop values for Red, Green and Blue for the fading.
  129. R2,G2,B2      This must be given.
  130.  
  131. R3,G3,B3      Optional values for the grow-down-factor. After CopperFade reaches
  132.               the middle of the given range, the fade will slightly grow to this
  133.               value.
  134.  
  135. Notes:
  136. ------
  137.  
  138. Send CopperFade a CTRL/C to quit it.
  139.  
  140. Attention: CopperFade will only test at start-time if there is allready  a  user
  141. copper  list installed on the given screen. But at the moment I have no idea how
  142. to test if other utilities (like MagicCopper) has obtained this  entry.  It  can
  143. come to strange results if this is so... like Guru-Time!
  144.  
  145.  
  146. ============================= Archive contents =============================
  147.  
  148. Original  Packed Ratio    Date     Time    Name
  149. -------- ------- ----- --------- --------  -------------
  150.    10295    3633 64.7% 04-Feb-98 09:56:26  copperfade10.c
  151.     6692    3490 47.8% 04-Feb-98 09:57:02  copperfade
  152.      921     514 44.1% 01-Feb-98 11:27:34  Makefile
  153.     5216    2290 56.0% 04-Feb-98 10:23:16  copperfade.readme
  154. -------- ------- ----- --------- --------
  155.    23124    9927 57.0% 12-Feb-98 23:22:36   4 files
  156.